home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / HYP / T-Z / XPrint Notes < prev    next >
Text File  |  1989-03-22  |  12KB  |  200 lines

  1.  
  2. Dear HyperCard Enthusiast:
  3.  
  4. I’ll be honest.  I think XPrint is the greatest thing since sliced bread.  If you’ve been frustrated by the inability to get attractive and useful printing out of HyperCard, except with slow and clumsy interfaces like... (did I hear someone mention Reports!)... I think that you will, too.
  5.  
  6. XPrint adds fast, full-featured, easy to use, highest-quality text printing to HyperCard.  It does so by adding a few new commands to HyperTalk, the HyperCard scripting language.
  7.  
  8. The commands are simplicity itself. The single command 'XPrint("Print", card field 1)', for example, will spool a competely formatted document.  The command 'XPrint("EndJob") prints it.
  9.  
  10. Or, you can combine an unlimited number of easy-to-use printing, formatting, and positioning commands to build a single, complex page or an entire document.  The possibilities are limited only by your imagination, like Macintosh applications are supposed to be.
  11.  
  12. How you wish each document to be formatted is up to you.  XPrint gives you the ability to exercise full control over how your document will look--directly from a HyperTalk script!
  13.  
  14. This means you can design forms, form letters, complex reports--literally anything--and get reliable, fast, high quality printing directly from HyperCard, and get it the way YOU want it.  Positioning measurements, by the way, are in inches and fractional inches, NOT screen dots or picas, making XPrint really easy to use.
  15.  
  16. Even better, you can do all this from ANY HyperCard stack.  Simply plug the 'XPrint' XFCN into either your Home stack or just the stacks you wish to use it with and that’s it.  No complicated installation procedures, no extra cards in your stacks, no jumping around to other applications or stacks, no quirky dialog boxes to horse around with.  Just results.
  17.  
  18. Now for the bad news.
  19.  
  20. As its title implies, this is a demonstration of the XPrint XFCN.  The version of XPrint included with this stack WILL NOT work with any other stack.  If you like XPrint, (and I’m sure you will) I‘ll make you a deal on the unrestricted version you won’t be able to turn down and still sleep nights.
  21.  
  22. But first, a brief word about how this demo stack works.
  23.  
  24. GENERAL CHARACTERISTICS
  25.  
  26. XPrint gives you about the same ability to format documents as any standard word processing application.  It lets you:
  27.  
  28.      • Set document sizes
  29.      • Set margins
  30.      • Set tabs
  31.      • Have full control over positioning
  32.      • Have full control over text fonts, styles, alignment, and spacing
  33.      • Mix text styles and alignments in the same page
  34.      • Print in either 'Best' or 'Faster' mode (it has its own 'Page Setup' dialog)
  35.      • (The demo version does not contain the line-drawing routines included in the unrestricted version.)
  36.  
  37. This demonstration stack offers a couple of simple examples of what you can do with XPrint.  The stack uses XPrint to print letters, envelopes, and mailing labels.
  38.  
  39. WRITING & PRINTING WITH THE XPRINT DEMO
  40.  
  41. Letterheads
  42.  
  43. The text block at the top of the screen is the first line of your letterhead (leave it blank if you don’t want to print a letterhead).  To change it, click on it and type what you want in the small text field that pops up.  The first line will be formatted as you specify (see below); subsequent lines are for your address.  Click on the 'Letterhead' block again to make the small address field go away.
  44.  
  45. Letters
  46.  
  47. This field (the one you’re reading) is where you type your letter.  You can also load and save letters as TEXT files with the Open... and Save... buttons to the right.  The small Trash can at the lower right clears this field.
  48.  
  49. Margins
  50.  
  51. To set margins for your letter, click on the small page icon above the 'Open...' and 'Save...' buttons.  You can set all margins at once by clicking where it says 'margins...' or set them individually by clicking on the appropriate numbers around the border.
  52.  
  53. Type Styles
  54.  
  55. To the left is a box containing standard Macintosh type styles.  Notice the two radio buttons above and below the style box.  When the bottom one is ON (highlighted), all formatting changes apply to this field.  When the TOP one is on, changes apply to your letterhead line.  Any combination of styles can be assigned independently to either your letterhead or the body of your letter.
  56.  
  57. Fonts & Font Sizes
  58.  
  59. Changing fonts and type sizes works the same way.  To change fonts, click the 'Fonts' button below.  Select the desired font from the font menu presented by clicking on its name.  Turn font selection off by clicking again on the 'Fonts' button.  Only the fonts currently installed will be shown, by the way.  If you add or delete fonts from session to session, the demo updates this menu each time you start it up.
  60.  
  61. Clicking the 'Size' button, below, gives you a menu of standard font sizes.  Select the desired size by clicking on it; remove the 'Size' menu by clicking on the 'Size' button again.
  62.  
  63. Additional Formatting Options
  64.  
  65. The 'Word Spacing', 'Line Spacing', and 'Paragraph Spacing' buttons apply only to this field, the body of your letter.  Use them to fine tune your final output.
  66.  
  67. PRINTING YOUR LETTER
  68.  
  69. The 'Page Setup' button presents the standard page setup dialog for your printer (NOT the one HyperCard uses).  For demonstration purposes, this stack includes a printing record formatted for standard business letters, a couple of different sizes of envelopes, shipping labels and mailing labels.
  70.  
  71. When you have formatted your letterhead and the body of your letter the way you want it, click the 'Print' button below.  This gives you the standard 'Job' dialog where you can select how you want your letter printed.  If you decide you want to cancel printing in the middle of a job, simply hit the standard 'Command-period' keys and you’ll exit neatly (unlike another, unnamed, HyperCard printing utility).
  72.  
  73. One of the nice features of XPrint is that it conforms exactly to the standard Macintosh printing interface.  There’s nothing extra to learn.  It behaves just as you might expect from your experience with other Macintosh applications.
  74.  
  75. ENVELOPES AND LABELS
  76.  
  77. We’ve mentioned envelopes and mailing labels.  To print one of the standard size envelopes or labels included here, first click on the 'Envelope' button below (this displays a picture of an envelope), type or paste in your return address and the address of the recipient, select which kind of envelope or label you want from the 'Page SetUp' dialog, then click the 'Print' button.  That's it.
  78.  
  79. When your envelope finishes printing, dismiss the envelope from the screen by clicking on the Envelope button again (or click on any blank portion of the envelope).
  80.  
  81. ...ABOUT THAT OFFER YOU CAN’T REFUSE
  82.  
  83. As mentioned above, this version of XPrint can only be used with this stack.  Please feel free to use it as long and as hard as you wish to see if XPrint is your cup of tea.  If you do decide you would like the unrestricted version, here’s the deal:
  84.  
  85. XPrint is only one of a number of new HyperCard multi-function XFCN’s included with STaK-X, a shareware collection of extensions to the HyperTalk scripting language written by Sam Thornton (that’s me).
  86.  
  87. STaK-X also includes a number of very useful tutorial and demonstration stacks showing how to use these new XFCN’s.  To get the unrestricted version of XPrint, PLUS all the rest of the XFCN’s and stacks in STaK-X, send $19.95 plus postage and handling fees (see below) to:
  88.  
  89.           STaK-X Software
  90.           508 Fairfield Avenue
  91.           PO Box 123
  92.           Fairfield, NE 68938-0123
  93.  
  94. P&H:  $3 US / $5 Canada & Mexico /$10 Overseas
  95. (Nebraska residents add 4% state sales tax)
  96.  
  97. When you consider that you could easily spend more than $40 alone for an inferior HyperCard printing utility (we’re not mentioning names here), I think you might agree this is a phenomenal bargain.
  98.  
  99. The reasons for the current low price are that you won’t get glitzy, four-color packaging, I don’t have a secretary or a press agent, and the only shareholder I have to answer to is me.  This may change, so don’t get caught short.
  100.  
  101. Some of the other goodies included in STaK-X...
  102.  
  103. Multi-Function XFCN’s:
  104.  
  105.      XPrint - (that’s what makes this stack
  106.      work)
  107.  
  108.      Strings - 28 advanced string functions
  109.      (including alpha and numeric sorts, word
  110.      and phrase replacements, string searches,
  111.      string formatting, indexing utilities, etc.,etc.,
  112.      etc.).  The latest version, completely re-
  113.      written.
  114.  
  115.      SFile - The COMPLETE implementation of
  116.      the Macintosh Standard File Package,
  117.      tailored for the HyperCard environment.
  118.  
  119.      Memory - Complete memory management
  120.      for HyperCard
  121.  
  122.      SysEnvirons - Pinpoints the hardware and
  123.      software environment your distributed
  124.      stacks are running on.  Includes complete
  125.      implementation of standard Macintosh
  126.      SysEnvirons plus other important additional
  127.      information.
  128.  
  129.      ScripX - Simply the best HyperTalk script
  130.      compacter/expander available at any price.
  131.  
  132.      UPSCharges - automates current UPS and
  133.      Federal Express rate charts (1989 update)
  134.  
  135.      ZipCheck - validates zipcodes for the 850+
  136.      three-digit zip areas in the 50 states
  137.      (1989 update)
  138.  
  139.      XScroll - simultaneous scrolling of scrolling
  140.      fields (not instantaneous, but much faster
  141.      than any other similar function; plus it only
  142.      takes one command to accomplish)
  143.  
  144.      PLUS a few other surprises...
  145.  
  146. Demonstration Stacks: (These are stacks written specifically as guides demonstrating how to use the many new functions included in STaK-X.  They are also pretty useful stacks in themselves.  Full script comments are included in addition to stack and XFCN documentation.)
  147.  
  148.      ListFinder - HyperCard version of the
  149.      familiar desk top list finder with added
  150.      features:  sophisticated cross-indexing,
  151.      automatic phone tracking logs, dialing
  152.      with modem or speaker, nearly instant
  153.      access to any listing, export and import
  154.      of entries, selective export of phone logs.
  155.      This is the primary tutorial for the
  156.      indexing utilities in the 'Strings' XFCN.
  157.  
  158.      ScriptPacker - I’m prejudiced, but I think
  159.      this may be one of the best HyperCard
  160.      utilities around for stack designers.  It
  161.      does script packing and expansion, highly
  162.      selective script search & replace, script
  163.      transfers between containers and stacks,
  164.      export and formatting of scripts for
  165.      publication or documentation.  It even
  166.      includes a mini-text editor for quick review
  167.      of scripts exported to text files.
  168.  
  169.      XText - A very interesting and friendly
  170.      search & replace for text in any stack’s
  171.      fields.  Good demonstration of many of
  172.      the most frequently used 'Strings' XFCN
  173.      functions.
  174.  
  175.      XPrint - (an expanded version of this stack)
  176.  
  177.      Transfer Menu - Installs a self-modifying
  178.      transfer button in any stack that lets you
  179.      transfer to any other stack or application
  180.      through a pop-up menu choice.  The menu
  181.      includes selections for updating itself.  It’s
  182.      kind of like having a desktop in a button.
  183.  
  184.      STaK-X Invoicer - a version of the stack
  185.      I use to print invoices and track
  186.      registrations (modified for general use).
  187.      This is another demonstration of how to
  188.      use XPrint to generate frequently used
  189.      forms.  Not a bad stack for a small business
  190.      user.
  191.  
  192. Naturally, I reserve the right to add as many other new XFCN’s and stacks as I can possibly fit in.  The above is the absolute minimum.  Plus, you will receive any new additions or modifications to STaK-X published in the year following your registration for NO additional charge.  (Well, maybe a buck or two for postage.)
  193.  
  194. In the meantime, as the saying goes, “Enjoy!”.
  195.  
  196. Sam Thornton
  197. 3/20/89
  198.  
  199. P.S.  Can you make a copy of this stack and give it away to your friends?  You bet.  As long as no money changes hands (except for nominal copying and distribution fees), the stack is passed on “as is” and this file accompanies the stack, there are no restrictions.
  200.